Skip to content

新增 Yac 内存管理章节并同步 doc-en #5822 的文档更新 - #1066

Open
laruence wants to merge 1 commit into
php:masterfrom
laruence:yac-docs-2026-09-02
Open

新增 Yac 内存管理章节并同步 doc-en #5822 的文档更新#1066
laruence wants to merge 1 commit into
php:masterfrom
laruence:yac-docs-2026-09-02

Conversation

@laruence

@laruence laruence commented Sep 2, 2026

Copy link
Copy Markdown
Member

概述

跟翻 doc-en c05fbe72ext/yac: Add a Memory Management chapter and improve the examples,PR php/doc-en#5822)。

改动

  • 新增 reference/yac/memory.xml(内存管理章节):键池 / 值池两套独立共享内存的布局、槽位驱逐与回收语义、容量规划与 Yac::info 计数器观察指标
  • book.xml:引入 &reference.yac.memory;,引言补基准测试链接与嵌入值整数范围修订(60 有符号位)
  • constants.xml:补全 YAC_VERSION / YAC_MAX_VALUE_RAW_LEN / YAC_MAX_RAW_COMPRESSED_LEN 的空描述,修正序列化器常量说明
  • ini.xml:更新 compress_threshold(默认 4K)与 keys_memory_size(默认 8M)默认值,重写两项内存说明并互链内存管理章节
  • add/set/get/delete/dump/info:参数名 keyskey 对齐 arginfo,示例按参数形式拆分为独立可运行片段,修正 hits 重置语义与 info 输出数字

中文排版

中文 prose 收成连续单行,消除跨行被 phd 渲染折叠成的汉字间空格(一并修正 dump.xml 等存量)。

校验

  • EN-Revision 指向 squash-merge 后的 doc-en master hash(c05fbe72),10 个文件本地复现 check-en-revision 全通过
  • check-structure.php 骨架镜像:divergent=0
  • section-order.php:0 issues;extensions.xml.php --check:通过
  • configure + phd 本地渲染:交叉链接全部解析,渲染后中文间空格 0

跟翻 doc-en c05fbe72(ext/yac: Add a Memory Management chapter and
improve the examples,PR #5822):

- 新增 reference/yac/memory.xml(内存管理章节):键池/值池两套独立共享
  内存的布局、槽位驱逐与回收语义、容量规划与 Yac::info 计数器观察指标
- book.xml:引入 memory 实体,引言补基准测试链接与嵌入值整数范围修订
- constants.xml:补全 YAC_VERSION / YAC_MAX_VALUE_RAW_LEN /
  YAC_MAX_RAW_COMPRESSED_LEN 的空描述,修正序列化器常量说明
- ini.xml:更新 compress_threshold(默认 4K)与 keys_memory_size(默认
  8M)默认值,重写两项内存说明并互链内存管理章节
- add/set/get/delete/dump/info:参数名 keys→key 对齐 arginfo,示例按参数
  形式拆分为独立可运行片段,修正 hits 重置语义与 info 输出数字

中文 prose 收成连续单行,消除跨行被渲染折叠成的汉字间空格(含 dump.xml
等存量)。EN-Revision 指向 squash-merge 后的 doc-en master hash。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant